home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / FROMUTS / MENON / !Menon / !Help / ReadMe < prev    next >
Text File  |  1991-03-20  |  15KB  |  282 lines
  1. *********************  Very boring Copyright Notice  **********************
  2. *                                                                         *
  3. *  All program code is the copyright of Joris RÖling and the 'borrowing'  *
  4. *    any part of it without the permission of the author is prohibited.   *
  5. *                                                                         *
  6. ***************************************************************************
  7.  
  8.  
  9.                              ReadMe file for !Menon 
  10.       
  11.                                      v1.86
  12.                                           
  13.            This version is a major improvement over the previous ones as
  14.           the CTRL key short-cuts now showup in the menu. If an item
  15.           has a short-cut, it will be shown in the menu by its key,
  16.           preceded with a conventional '^' (this means CTRL). This
  17.           feature was suggested to me (by CC) quite a while ago, I
  18.           never came to do it as it required a rewrite of a importand
  19.           routine in Menon (for the technical minded: as the menu
  20.           entries are now somtimes longer then 12 chars, they have to
  21.           be redirected. Previously an item was never longer than 11
  22.           chars as filenames are limited to 10 chars.)
  23.  
  24.  
  25.           Preface  ___________________________________________________
  26.  
  27.            In this version the Short-cut option has been changed to
  28.           Option. In the new Option window, there has been added the
  29.           option to startup the relevant task automaticly when Menon
  30.           is started. Now it is also possible to open the Option
  31.           window (previously called Short-cut window), by selecting a
  32.           task by menu selection, while holding down the CTRL key.
  33.           Read the Option section for details.
  34.  
  35.           This version has a (Conf) option added: you can specify if
  36.           you want a beeb when a directory is selected with Ctrl-Tab.
  37.           (See Configuring Menon)
  38.  
  39.            Introduction  _____________________________________________
  40.  
  41.            This little tool will allow you to launch your applications
  42.           by a menu selection. It will create a window on the back
  43.           (you won't see it except for its logo), or a icon on the
  44.           iconbar, and whenever you press the menu button while over
  45.           this back window (c.q. icon on the iconbar) you'll get a
  46.           menu. This menu can be setup to become a menu tree (with
  47.           submenus), as complex as you like.
  48.  
  49.            In the menu is of course the Info item, with the copyright
  50.           notice. There is also a Submenu item, which will allow you
  51.           to create new submenus.
  52.           
  53.           Setup window  _____________________________________________
  54.  
  55.            Clicking in the Menon icon (wether it is on the iconbar or
  56.           on the back window) will come up with a window. This is the
  57.           Setup window, and allows to setup Menon to your needs. Here
  58.           you see how much memory there is free, how much entries
  59.           there are, you can tell if you want Menon on a back window
  60.           or on the iconbar, the current menu is shown, and you can
  61.           save all changes you made. (See also the MenonFlags keyword)
  62.  
  63.            The idea behind Menon is to have a alternative for the
  64.           Filer. It allows you to organise files in a different way
  65.           than the way they are stored on disc. For example, you could
  66.           organise files together in a menu, which are stored on
  67.           separate discs. Another advantage is the fact that the menus
  68.           are there at an instance. No long waiting before the filer
  69.           has read all icons of applications.
  70.            
  71.            To setup your own menu tree you'll have to do the
  72.           following.
  73.           
  74.           Create new submenu  _______________________________________
  75.  
  76.            To create a submenu, you need the second item in the Main
  77.           menu. Here you enter the name of the submenu you want to
  78.           create. This name will be added to the Current menu. You can
  79.           make a submenu the 'Current menu' by selecting its name in
  80.           the parent menu when the 'Select item' option in the Setup
  81.           window is on. This will create a tick, to show which submenu
  82.           is the current one. When first started, the Main menu is the
  83.           Current menu. This is shown by the 'Current menu' section in
  84.           the Setup window. Below this is the 'Main' button which can
  85.           be used to select the Main menu. Selecting a ticked
  86.           (selected) menu item will have the same effect. Whenever you
  87.           add a file, or create a new submenu, it will be added to the
  88.           Current menu. You can create submenus eight levels deep.
  89.           This is limited by the WindowManager.
  90.           
  91.           Adding file(s)  ___________________________________________
  92.  
  93.            To add files to the Current menu, you only have to drag
  94.           them from the directory viewer to the Menon logo (on the
  95.           back window or the iconbar). Menon will confirm by rotating
  96.           its icon. You can also add direcories to the list. When
  97.           selecting one of these, its directory viewer will be opened.
  98.           Selecting an application while holding down SHIFT will also
  99.           open the directory viewer (like in the Filer). As a matter
  100.           of fact, Menon completely imitates the way the Filer reacts
  101.           on mouse clicks. For example, if you added a plain text
  102.           file, and selected it in its menu, Menon first looks if
  103.           there is a application running which would like to open the
  104.           file (e.g. !Edit) before it executes the associated alias
  105.           (in this example, this last bit starts !Edit which in turn
  106.           will read the file in) . Menon disallows menu items to have
  107.           the same name, even if they come from a separate disks. This
  108.           is rather like ADFS; to have the same file twice on one
  109.           disc, you will have to put them in different subdirectories
  110.           (here: submenus). When the filename of the file you just
  111.           added already exists in the Current menu, you'll be asked if
  112.           you want to overwrite the old menu item.
  113.           
  114.           Removing file(s)  _________________________________________
  115.  
  116.            To remove files from a menu, you have to select the 'Remove
  117.           item' option in the Setup window, and select the relevant
  118.           item in the menu. If it is a (non empty) submenu, you'll get
  119.           a warning, and when confirmed it recursively deletes all
  120.           subsequent entries. To remove multiple items you can select
  121.           them with the adjust button, so the menu will not be removed
  122.           after a selection. When you delete the Current menu, the
  123.           Main menu will become current. The menutitle will be cream
  124.           to show you are in the Remove mode. While in this mode, you
  125.           cannot create submenus, or add files.
  126.           
  127.           Setting up the file options  ______________________________
  128.  
  129.            It is possible to setup keyboard short-cuts. To do this
  130.           you'll have to select the 'Option' option in the Setup
  131.           window. Now, when you select a menu item, a window appears,
  132.           called the Option window. It shows the selected item and
  133.           the key which, when pressed together with Ctrl, will act as
  134.           if you selected the item in Select mode. If no key is shown,
  135.           it means it has no short-cut yet. The icon showing the key
  136.           is a writable icon, so there you enter the desired key.
  137.           Clicking OK, or pressing return will assign the new key to
  138.           the menu item. Only the characters A-Z are allowed here, and
  139.           a key may only occur once. The window also contains a
  140.           section stating 'Imm. startup' (Immediat startup), with the
  141.           following meaning: If the option is selected, the relevant
  142.           task will be started automaticly as soon Menon itself starts
  143.           up. Also if you decided to leave the desktop, and re-enter
  144.           it, all tasks with this option set, will restart.
  145.  
  146.            If for some reason you don't want the tasks to start up,
  147.           when ALT is hold down at the time Menon itself starts up,
  148.           the setting of this option will have no effect, i.e. no
  149.           tasks will start up.
  150.                           
  151.           Click modes  ______________________________________________
  152.  
  153.            It should be noted that what happens after menu selection,
  154.           depends on the 'Click mode' of Menon. The click mode affects
  155.           the options desribed above. So there is a 'Select mode', a
  156.           'Remove mode' and a 'Short-cut mode'. A menu selection in
  157.           Select mode will start a task if a 'File' was selected, or
  158.           make a submenu Current if a submenu was selected. The menu
  159.           titlebar will have a gray background to show Menon is in
  160.           Select mode (normal mode). In any other mode, the titlebar
  161.           background colour will be cream, and the Submenu item will
  162.           be shaded, to illustrate that any menu selection will only
  163.           have effect on the setup of Menon. 'Remove mode' will only
  164.           have effect if the Setup window is open (shown) to prevent
  165.           unwanted removal of menu items. 'Short-cut mode' will only
  166.           have effect if (either or both) the Setup window or the
  167.           Short-cut window is open. When Menon is started it is in
  168.           Select mode.
  169.  
  170.           Back window  ______________________________________________
  171.  
  172.            When other tasks are claiming the back window as well, some
  173.           problems may arise when using the back window. It is
  174.           unpredictable which one of the back windows will be on top
  175.           of which, so you may lose track of Menon. If so, you should
  176.           know Menon is still there, but to access it you'll have to
  177.           quit the other task. You can use Menon from the iconbar by
  178.           selecting the 'Iconbar' option in the Setup window. This way
  179.           you could use Menon as well as the other task. This
  180.           selection is saved together with the menu structure when you
  181.           select the 'Save setup' option.
  182.           
  183.           Adjust button  ____________________________________________
  184.                                        
  185.            You can use the Adjust button (right mouse button) to
  186.           select a menu item. This will prevent the menu to be removed
  187.           after your selection. 
  188.           
  189.           Memory  ___________________________________________________
  190.  
  191.            Menon makes use of a heap to store its internal data. You
  192.           may specify the size of this heap by passing the required
  193.           number of K's as a argument of !RunImage in the !Run file of
  194.           the !Menon application. If no argument is specified, Menon
  195.           will create a heap with the default size of 4K. Because of
  196.           the internal data structure, sometimes gaps of free space
  197.           are created, which are to small to use for new data. This is
  198.           rather like the OLD disc structure (D & L) of ADFS. The
  199.           'Comp' button in the Setup window tries to compact the heap,
  200.           which can be examined at the 'Largest' section. This again
  201.           is like the old days: it shufles the data (like *Compact),
  202.           so pressing this button again will sometimes increase the
  203.           'Largest' section again. Compacting will only be necessary
  204.           when memory is running out.
  205.           
  206.           Menon Task  _______________________________________________
  207.  
  208.            Menon is a module task, which means it stays in the RMA
  209.           area. When choosing 'Quit' from the Task window, or 'Exit'
  210.           from the Task menu (<Ctrl> <Shift> F12), and whenever a soft
  211.           reset is generated the Menon task will be killed, but the
  212.           module will still be there and its data intact. Whenever the
  213.           Desktop is re-entered Menon will startup itself. Using
  214.           'Quit' from the Setup window will quit the task and the
  215.           module (see below). But who cares, it only uses ± 17K (plus
  216.           heap) of memory. Selecting Quit from the Setup window, while
  217.           some changes have been made will result in a warning.
  218.           
  219.           Configuring Menon  ________________________________________
  220.  
  221.            Menon allows you to configure its internal functioning.
  222.           This is done in the Configure window which will pop up when
  223.           clicking on the 'Conf' button in the Setup window. The
  224.           various option are quit self explaining, but a short
  225.           description folows. When the option is selected it means:  
  226.  
  227.           - Every time a new submenu is created, it will be made
  228.           'Current', so that all files you'll drop on the Menon icon
  229.           will appear in the new menu. 
  230.  
  231.           - As a default, 'Quit' in the Setup window will kill the
  232.           entire Menon module, but now it will only quit the task, so
  233.           that when you next issue the *Desktop command, Menon will
  234.           re-appear.
  235.  
  236.           - As a default, quiting Menon from the Task window, or when
  237.           you Exit the desktop, only the Menon task is killed, but now
  238.           it will kill the Module aswell. 
  239.  
  240.           - When you remove a submenu still containing items (unempty),
  241.           there will be no warning.
  242.  
  243.           - When file is added, and in the Current menu is a item with
  244.           the same name, it will overwrite the old one without
  245.           warning.      
  246.  
  247.           - When you select a directory by putting the pointer over a 
  248.           directory viewer, and pressing Ctrl-Tab, a beeb will confirm
  249.           the directory change.
  250.  
  251.           It is recomended that the unexperienced user has all
  252.           switches set to 'off' (not selected). The setting of the
  253.           switches will be saved next to the other data when 'Save' is
  254.           next selected.
  255.           
  256.           Bonus keys  _______________________________________________
  257.  
  258.            As a bonus, the F11 key has been programmed to open the
  259.           Task window of the Task Manager. It acts as if the 'Task
  260.           display' item of the Task menu is selected. Pressing
  261.           Shift-F11 has the function of closing all open Filer windows
  262.           (directory viewers). Ctrl-Tab will make the directory who's
  263.           viewer is open, and where the pointer is over, the current
  264.           directory. The Menon icon will rotate to acknowledge the
  265.           directory change.
  266.           
  267.  
  268.            If you have any suggestions, or you found some bug, or if
  269.           you just want to tell me how great you think this program
  270.           is, write a note to the address below.
  271.  
  272.  
  273.                              To contact the author, write or ring to:
  274.  
  275.                                           Joris RÖling
  276.                                           Kikkerstraat 17a
  277.                                           2515 NB Den Haag
  278.                                           The Netherlands
  279.  
  280.                                           Tel:070-3840403
  281.  
  282.